Changes for DLG V1.27 AreaEd o New module. This is a complete replacement for DLG:MsgAreas and DLG:FileAreas all in one. It is launched differently depending on whether you wish to edit file or message areas. It automatically works with templates generated with AreaTemplate, making area creation a BREEZE. Just a few keystrokes and BOOM, you're done. AreaTemplate o New module. Gives the sysop the ability to create and administer file and message area TEMPLATES. Use these templates with the file and message area editors to quickly create several areas without having to retype the same information over and over again. This module is pre-configured in AreaEd's menu. CompileScreen o There was a nasty bug in CompileScreen that nobody was catching -- guess they didn't use it -- but it's fixed, anyway. Changed all file IO to dos-pure and added some error checking. DLGRexx.library o Added this library to provide an ARexx interface to many dlg.library functions. In this release, only the port-specific functions (LockPort, FreePort, etc) are implemented. Message System o Added a new config directory: DLGConfig:Fido . This directory will eventually be the home of ALL fidonet configs. o Added a new config file: DLGConfig:Fido/Domains. This file tells DLG what your default address is, and what your default address is for each domain that you are in. See docs for more details on how to use it. DLGNet o DLGNet no longer remaps the INTL kludge if you are sending from one zone to another. This will be changed in the near future to allow DLGNet to override the kludges if needed, but it will be done observing the restrictions of DLGConfig:Fido/Domains instead of its own rather limited view of the world :-) Mess o Now uses DLGConfig:Fido/Domains to determine the proper FROM address when writing netmail outside of FidoNet. SendMsg o SendMsg was setting the CRASH bit whenever a netmail message was sent, regardless of flags set in the command line. SendMsg changed to assume that the settings on the command line override the settings in fidonet.settings. o Now uses DLGConfig:Fido/Domains to determine the proper FROM address when writing netmail outside of FidoNet. DLGTick o DLGTick now recognizes a new keyword in an area definition - USEADDR. If USEADDR is present, DLGTick will substitute the specified address for your own address. For example, if you are in AmigaNet and hatch a file out as 39:100/101, you'll notice that previous versions would put your default Fido address in its place. Now, you can specify your AmigaNet address and it will be put in place of your Fido address in all cases. The one exception is the SEENBY statement -- your primary address is left in there, but the specified address is also added as well. This gives an extra layer of protection against dupes coming back to haunt you. =========== Implementing Changes ============== 1. Adding AreaEd to your system 2. Using AreaTemplate Seperately 3. Using dlgrexx.library 4. Configuring Domains 5. Configuring DLGTick for multi-domain operation 6. AreaEd Command Line Options 7. AreaTemplate Command Line Options 8. AreaEd Commands 9. Area Parameters 10. AreaTemplate Commands 11. Area Template Parameters 12. Resource Manager Error Codes (for dlgrexx.library) 1. Adding AreaEd to your System AreaEd totally replaces both MsgAreas and FileAreas, the file and message area configuration programs. The installer script should have done everything for you except actually editing your menus to point to the new programs. While it is possible to change the menus blindly, we have no way of knowing if you kept the default settings, so this last step must be performed by you. For the purposes of this procedure, we will assume that you are using the default Sysop menu that was supplied with DLG. You will be using the [C] CONFIGURE MENUS command to edit the SYSOP menu, specifically the [D] DEFINE / EDIT MESSAGE AREAS and [F] FILE AREA DEFINE / EDIT commands. If your sysop menu does not have these entries, we are going to assume that you know what you are doing and can figure out the generalities on your own. :-) From the sysop menu, select [C] to enter the Menu Editor. Select [S] to SELECT the menu to edit and then select the SYSOP menu. You can [L] LIST the menu to verify that you have the right menu. Assuming you do, select [E] to edit an item, then select D to edit the DEFINE / EDIT MESSAGE AREAS item. Item [2] should be set to "DLG:MsgAreas". You will need to change this to "DLG:AreaEd". If you had other command line options (such as -o) for MsgAreas, you should add them for AreaEd as well. Now, select [E] to edit an item, then select F to edit the FILE AREA DEFINE / EDIT item. Item [2] should be set to "DLG:FileAreas". You will need to change this to "DLG:AreaEd -f". If you had other command line options (such as -o) for MsgAreas, you should add them for AreaEd as well. NOTE THE -f COMMAND LINE OPTION -- THIS IS HOW AREAED KNOWS TO EDIT FILE AREAS INSTEAD OF MESSAGE AREAS. Assuming all was done correctly, you are now ready to use the new area editor modules. Later on in this document you will find a short user-guide on how to use them. The program also comes with some pre-defined help files which have also been installed for you. 2. Using AreaTemplate Seperately AreaTemplate is normally called by AreaEd when you tell AreaEd that you want to edit templates ("T" in the default menu). However, if you wish to break it out to a seperate menu, you may. It is configured exactly like AreaEd above, except of course the name of the program is different. 3. Using dlgrexx.library dlgrexx.library is a new addition as of V1.27. It is a shared Arexx function library that is only available to Arexx scripts. C or asm programmers will have no need of it. To use dlgrexx.library in your Arexx scripts, you simply call the functions listed for the library from your script as you would any Arexx function call. Before you can do this, however, you must have the library open. Near the beginning of your code, add the following: if ~show(l, "dlgrexx.library") then do if ~addlib("dlgrexx.library", 0, -30, 0) then do say "Could not load dlgrexx.library." exit(20) end end This should especially be present if you plan on distributing your Arexx programs to other users. A full list of supported commands is included in dlgrexx.doc. 4. Configuring Domains Domains when used in a FidoNet context refer to different networks. FidoNet itself is a domain that encompasses zones 1 through 7. AmigaNet is another domain, this one encompasing zones 39 through 41. Domains are important if you wish to treat different zones as if they were within one network. Previously, DLGMail took care of this for you as long as the domain in question was FidoNet, but it did not for other domains. The Domains configuration file and the code that uses it is a more thorough and flexible solution. If you are not participating in any FidoNet-tech networks, you won't need to configure the Domains file. Everyone else will. In DLGConfig:Fido you will find a sample file called _Domains. Rename or copy this to DLGConfig:Fido/Domains and open it with a text editor. You should see something like this: ;this is a comment DEFAULT 1:202/720.0 ; this is a comment DOMAIN fido Address 1:202/720.0 Zone 1 Zone 2 Zone 3 Zone 4 Zone 5 Zone 6 @Domain DOMAIN amiganet Address 40:405/101.0 Zone 39 Zone 40 Zone 41 @domain DOMAIN podsnet Address 93:9085/1 Zone 93 @domain This example config file contains descriptors for three domains. You will need at least one domain to be configured. The following keywords are used in the Domains file: ; Comments are preceded by a semicolon. A comment may start anywhere on a line -- everything following it on that line is ignored. DEFAULT The DEFAULT keyword indicates that what follows is your default address. If a domain is not matched by the program using this file, it will use the default address for mail that is originating on your system. DOMAIN Starts a DOMAIN block. Following this keyword is a mnemonic that indicates what domain you are defining. This information will not be shared with other systems, so you can name it whatever you want as long as you use it consistently throughout your system. Case is not important. @DOMAIN Ends a DOMAIN block. ADDRESS Only valid within a DOMAIN block. For the domain in question, this will be the address that your system is known by. ZONE Only valid within a DOMAIN block. You may have as many ZONE lines as you desire for a DOMAIN. Each ZONE keyword is followed by the number of a zone that is contained within the domain in question. 5. Configuring DLGTick for Multi-domain Operation DLGTick in this release will allow use in other than your default domain as well as gate across domain boundaries. For this to work, you must add the UASEADDR keyword. USEADDR must be added within an AREA block and tells DLGTick that for that area, your address is what follows the USEADDR keyword. Example: AREA Z40Amiga DESC Zone 40 AmigaNet Admin PURGE REPLACE LocalArea 74 TO 40:402/101.0 H TO 40:711/15.0 H TO 40:800/765.0 H USEADDR 40:405/101 ANNOUNCE MULTI 494 ANNOUNCE MULTI 495 ANNOUNCE MULTI 496 In this example, I am using my AmigaNet address and want it to appear in the SEENBY lines of the resultant TIC file. 6. AreaEd Command Line Options AreaEd has the following template: AreaEd [-s ] [-m ] [-f] [-o] Meaning: -s Tells AreaEd to pre-load a command stack that will be executed when the user enters the program. -m Tells AreaEd to use the indicated menu config instead of AREAED_MAIN. -f Tells AreaEd that it will be editing file areas. If left out, AreaEd will edit message areas. -o Tells AreaEd to launch in OVERLAY mode, where the launching program will stay resident in memory and that program will resume when AreaEd exits. By default, AreaEd is launched in CHAIN mode and automatically re-loads DLG:Menu at the menu you launched AreaEd from. 6. AreaTemplate Command Line Options AreaTemplate has the following template: AreaTemplate [-s ] [-m ] [-f] [-o] Meaning: -s Tells AreaTemplate to pre-load a command stack that will be executed when the user enters the program. -m Tells AreaTemplate to use the indicated menu config instead of ATEMP_MAIN. -f Tells AreaTemplate that it will be editing file area templates. If left out, AreaTemplate will edit message area templates. -o Tells AreaTemplate to launch in OVERLAY mode, where the launching program will stay resident in memory and that program will resume when AreaTemplate exits. By default, AreaTemplate is launched in CHAIN mode and automatically re-loads DLG:Menu at the menu you launched AreaTemplate from. AreaEd launches AreaTemplate in OVERLAY mode so that you can return directly back to AreaEd when you are done. 7. AreaEd Commands Available Functions Function Builtin Name Purpose ======== ============ ================================================== Add Area AreaEd_New Takes you through the process of adding a new file or message area. If you have previously created templates, you may use those templates to create the area when prompted. Once an area is created, you are presented with the option to further edit it before committing to saving it. Edit Area AreaEd_Edit Presents you with a menu of parameters that you can edit as needed. See Area Parameters for details) List Areas AreaEd_List Presents you with a list of valid file or message areas. Delete Area AreaEd_Delete Delete an existing file or message area. The area parameters are removed from the BBS list, the area is purged from all users' newscan lists, and the area's directory is deleted from FILE: or MSG:. Alt file paths are NOT deleted. There is no undo for this function!! Move Area AreaEd_Move "Move" (renumber) an existing area to a new number. This operation changes the area definition in the BBS list, changes the number in all users' newscan lists, and renames the area's directory in MSG: or FILE:. At this time, the alt file path is NOT renamed, though you can change that parameter in the area definition. Templates AreaEd_Temp Enter the Template Editor Menu. Exit Menu AreaEd_Exit Leave the Area Editor and return to the previous (assumed to be SYSOP) menu. Help Help Display online help for a command key that you will be asked to choose. Re-Display DisplayMenu Clears screen and re-draws the menu. This is usually only useful if you are (1) online and have suffered line noise, or (2) if you are in Expert or Intermediate help mode and wish to see the full text of the menu. 9. Area Parameters Key M|F Parameter Notes === === =================== ================================================ 1 M F Auto-Access If this flag is set, you will have the option to automatically add the new area to the users' new-scan list. When you un-set this parameter, the auto-access levels are reset to 1 and 1 and all users are purged from of the area. 2 M F Auto-Access Level If the auto-access flag is set, you have the ability to set or change what level of user is automatically included in the area. Must be between 1 and 255, and the upper limit cannot be lower than the lower limit. 3 M F Write Access (M) Upload Access (F) This controls the level of user that is allowed to write (upload) to the area. Must be between 1 and 255, and the upper limit cannot be lower than the lower limit. 4 M F Kill Access This controls the level of user that is allowed to kill messages or files in the area. Must be between 1 and 255, and the upper limit cannot be lower than the lower limit. NOTE: Users can only kill messages or files that they themselves wrote / uploaded on your BBS, unless they have sysop (usually 255) access. You need not worry about deranged users deleting messages or files all over the place. 5 M F Forward Access (M) Download Access (F) This controls the level of user that is allowed to forward (download) messages (files) from the area. Must be between 1 and 255, and the upper limit cannot be lower than the lower limit. NOTE: Users can only forward messages to areas on the BBS that they have access to unless they have sysop (usually 255) access. 6 M F Copy/Move Access (M) Transfer Access (F) This controls the level of user that is allowed to copy or move (transfer) messages (files) from the area. Must be between 1 and 255, and the upper limit cannot be lower than the lower limit. NOTE: Users can only copy/move (forward) to areas on the BBS that they have access to unless they have sysop (usually 255) access. 7 M Edit Access This controls the level of user that is allowed to edit messages in the area. Must be between 1 and 255, and the upper limit cannot be lower than the lower limit. NOTE: Users can only edit what they themselves wrote on your BBS, unless they have sysop (usually 255) access. 8 M F Sysop Access This controls the level of user that is allowed to perform Sysop functions in the area. Must be between 1 and 255, and the upper limit cannot be lower than the lower limit. You should be very careful changing this to anything other than 255! Users with Sysop access can do any of the above actions! 9 M Echo Area This flag indicates that the message area will be hosting Echomail from a fidonet-tech network. This flag cancels the Netmail and Newsgroup flags. 10 M Hide Seen-Bys This flag indicates that messages displayed in this area will not show the "Seen-By Kludge" lines in the message. While this information is useful for a sysop, it is of little use to most other people. This flag is only available for Echomail areas. Defaults to YES. 11 M Origin Line Each message you write in an Echomail area must contain an Origin Line. Normally, DLG uses the default origin line defined in the FidoNet Settings Editor. However, you may wish to create a different origin line for different echo types. Additionally, if the echo belongs to a network other than your default network (domain), you must define the origin line AND include your address at the end of the line within parenthesis, e.g. The Techno-Mages' Guild * 613.619.1429 (40:405/101) This setting is only available for Echomail areas. Defaults to the system default. 12 M Netmail Area This flag indicates that the message area will be hosting Netmail from a fidonet-tech network. This flag cancels the Echomail and Newsgroup flags. Note that while you may define as many netmail areas as you wish, DLGMail only recognizes one netmail area per system. 13 M Newsgroup This flag indicates that the message area will be hosting a newsgroup from a UUCP network. This flag cancels the Echomail and Netmail flags. 14 M Newsgroup Name This parameter indicates which newsgroup is being imported into this message area. If you set the Newsgroup flag above, you must enter something in this field. The editor will not let you exit until you do so. 15 M F Use Handles This flag indicates that messages posted in the message area will be tagged with the users' aliases (handles) rather than thier real names. You should be careful with this flag, as many networked message areas (especially fido-tech) do not allow aliases in echos. Defaults to NO. 16 M F Use Signatures This flag indicates that posts in the area will be tagged with the users' signature. DLG offers three types of signatures for message areas: normal (the default), FidoNet (used in Echo areas), and UUCP (used in newsgroups). There is also a special signature for file areas. If one of the latter does not exist, the default signature will be used. If that does not exist, no signature will be appended. 17 M F Translator A Translator is an external program that changes the text in some way. In the past, DLG has shipped with programs such as Jive or kraut that gave mock accents (the latter provided a mock German twist) to the message. Digerati Dreams has discontinued these programs for personal reasons. However, the ability to use such programs is still in place. If you wish, you may consult the three batch files Spare1.batch, Spare2.batch, and Spare3.batch for hints on how to use translator files. 18 F File Requestable This flag indicates that files in the area area are available for FidoNet File REQuests (FREQs) from other BBSs. You should never place sensitive files in file requestable areas. 19 F Copy before Download This flag indicates that files should be copied to a temporary directory before they are downloaded. This is most useful for BBSs that offer more than 1 CD on a "turntable" system. Because of the multitasking nature of the Amiga, it is conceivable that users on different lines might be requesting files from different CDs at the same time, causing excessive wear and tear on the changer (and the sysop's nerves!) 20 F Validate Uploads This flag indicates that files uploaded to the area must be validated before they can be made available to users or for FREQing. You will be alerted to unvalidated files next time that you log on the BBS. 21 M F Message Capacity (M) Validation Area (F) Message Areas: This defines how many messages are to be kept in the message area. When more than that number of messages is added to the area (user writing message, imported message), the lowest number message will be deleted until the number of messages is equal to this number. Any number between 10 and 9000 may be entered. Defaults to 100. File Areas: If the Validate Uploads flag is set, this number will indicate a file area to copy the file to while it is awaiting validation. Not to worry, when the file is validated it will be returned to whence it came. You do not have to set an area here, as the file can be held right where it is if you wish. 22 M Renumber Trigger When the message number of the highest message in an area exceeds this number, the message area will be renumbered. To cut down on system drag, this only occurs when you, the sysop, run the Renumber utility. This number cannot be lower than the capacity of the area. Defaults to 500. Cannot be more than 9999. 23 M Character Set This defines a character set to use to translate messages to another format, such as Norwegien character sets or Macintosh 7-bit. You may only select from a list of installed character sets. Defaults to 0 (PORT DEFAULT). 24 F Alt File Path Files are normally stored in FILE:/, but you may choose an alternate directory to store them in; this is especially usueful for spreading the load over several drives or partitions. If nothing is set here, the default file path is used. You may enter a path up to 18 characters in length for the alt path. If the specified directory does not exist, it will be created. 25 M F Edit EnterArea.Txt If a file called EnterArea.Txt exists in the message or file area's directory, it will be displayed whenever a user enters the area. You may edit the file on the spot using this command. 26 M F Delete EnterArea.Txt If a file called EnterArea.Txt exists in the message or file area's directory, it can be deleted on the spot using this command. 27 M Edit EchoArea.Txt If a file called EchoArea.Txt exists in a message area's directory, AND that area is an echo area, it will be displayed whenever a user posts to the area. You may edit the file on the spot using this command. 28 M Delete EchoArea.Txt If a file called EchoArea.Txt exists in the message area's directory, it can be deleted on the spot using this command. 29 F Edit UploadFile.txt If a file called UploadFile.Txt exists in a file area's directory, it will be displayed whenever a user uploads to the area. You may edit the file on the spot using this command. 30 F Del UploadFile.Txt If a file called UploadFile.Txt exists in the file area's directory, it can be deleted on the spot using this command. 31 M Edit Screen.dat If a file called Screen.dat exists in a message area's directory, messages written in that area will be screened for words of your choosing, and those words replaced with words also of your choosing. This command will allow you to edit it on the spot. See Editing Screen.dat for details on how this works. This command also compiles the generated file for you. 32 M Delete Screen.dat If a file called Screen.dat exists in the message area's directory, it can be deleted on the spot using this command. 33 M F Apply Template Using this powerful command, you can "blast" all the current settings for an area and apply a set of parameters from a template. Once the template is applied, you can edit it further if needed. 10. AreaTemplate Functions Function Purpose ==================== ======================================================== List Templates Shows a list of all applicable templates (file or message) Create Templates Takes you through the process of creating a new template from scratch (see Template Parameters for details) Edit Template Make changes to an already-existing template. (see Template Parameters for details) Copy Template Copy an existing template over to a new one, which you may then edit. Rename Template Rename an existing template. Delete Template Delete one of your existing templates. Exit Template Menu Leave the Template Editor and return to the previous menu. Help Display online help for a command key that you will be asked to choose. Re-Display Clears screen and re-draws the menu. This is usually only useful if you are (1) online and have suffered line noise, or (2) if you are in Expert or Intermediate help mode and wish to see the full text of the menu. 11. Area Template Paramemters Key M|F Parameter Notes === === =================== ================================================ 1 M F Auto-Access If this flag is set, you will have the option to automatically add the new area to the users' new-scan list. When you un-set this parameter, the auto-access levels are reset to 1 and 1 and all users are purged from of the area. 2 M F Auto-Access Level If the auto-access flag is set, you have the ability to set or change what level of user is automatically included in the area. Must be between 1 and 255, and the upper limit cannot be lower than the lower limit. 3 M F Write Access (M) Upload Access (F) This controls the level of user that is allowed to write (upload) to the area. Must be between 1 and 255, and the upper limit cannot be lower than the lower limit. 4 M F Kill Access This controls the level of user that is allowed to kill messages or files in the area. Must be between 1 and 255, and the upper limit cannot be lower than the lower limit. NOTE: Users can only kill messages or files that they themselves wrote / uploaded on your BBS, unless they have sysop (usually 255) access. You need not worry about deranged users deleting messages or files all over the place. 5 M F Forward Access (M) Download Access (F) This controls the level of user that is allowed to forward (download) messages (files) from the area. Must be between 1 and 255, and the upper limit cannot be lower than the lower limit. NOTE: Users can only forward messages to areas on the BBS that they have access to unless they have sysop (usually 255) access. 6 M F Copy/Move Access (M) Transfer Access (F) This controls the level of user that is allowed to copy or move (transfer) messages (files) from the area. Must be between 1 and 255, and the upper limit cannot be lower than the lower limit. NOTE: Users can only copy/move (forward) to areas on the BBS that they have access to unless they have sysop (usually 255) access. 7 M Edit Access This controls the level of user that is allowed to edit messages in the area. Must be between 1 and 255, and the upper limit cannot be lower than the lower limit. NOTE: Users can only edit what they themselves wrote on your BBS, unless they have sysop (usually 255) access. 8 M F Sysop Access This controls the level of user that is allowed to perform Sysop functions in the area. Must be between 1 and 255, and the upper limit cannot be lower than the lower limit. You should be very careful changing this to anything other than 255! Users with Sysop access can do any of the above actions! 9 M Echo Area This flag indicates that the message area will be hosting Echomail from a fidonet-tech network. This flag cancels the Netmail and Newsgroup flags. 10 M Hide Seen-Bys This flag indicates that messages displayed in this area will not show the "Seen-By Kludge" lines in the message. While this information is useful for a sysop, it is of little use to most other people. This flag is only available for Echomail areas. Defaults to YES. 11 M Origin Line Each message you write in an Echomail area must contain an Origin Line. Normally, DLG uses the default origin line defined in the FidoNet Settings Editor. However, you may wish to create a different origin line for different echo types. Additionally, if the echo belongs to a network other than your default network (domain), you must define the origin line AND include your address at the end of the line within parenthesis, e.g. The Techno-Mages' Guild * 613.619.1429 (40:405/101) This setting is only available for Echomail areas. Defaults to the system default. 12 M Netmail Area This flag indicates that the message area will be hosting Netmail from a fidonet-tech network. This flag cancels the Echomail and Newsgroup flags. Note that while you may define as many netmail areas as you wish, DLGMail only recognizes one netmail area per system. 13 M Newsgroup This flag indicates that the message area will be hosting a newsgroup from a UUCP network. This flag cancels the Echomail and Netmail flags. 15 M F Use Handles This flag indicates that messages posted in the message area will be tagged with the users' aliases (handles) rather than thier real names. You should be careful with this flag, as many networked message areas (especially fido-tech) do not allow aliases in echos. Defaults to NO. 16 M F Use Signatures This flag indicates that posts in the area will be tagged with the users' signature. DLG offers three types of signatures for message areas: normal (the default), FidoNet (used in Echo areas), and UUCP (used in newsgroups). There is also a special signature for file areas. If one of the latter does not exist, the default signature will be used. If that does not exist, no signature will be appended. 17 M F Translator A Translator is an external program that changes the text in some way. In the past, DLG has shipped with programs such as Jive or kraut that gave mock accents (the latter provided a mock German twist) to the message. Digerati Dreams has discontinued these programs for personal reasons. However, the ability to use such programs is still in place. If you wish, you may consult the three batch files Spare1.batch, Spare2.batch, and Spare3.batch for hints on how to use translator files. 18 F File Requestable This flag indicates that files in the area area are available for FidoNet File REQuests (FREQs) from other BBSs. You should never place sensitive files in file requestable areas. 19 F Copy before Download This flag indicates that files should be copied to a temporary directory before they are downloaded. This is most useful for BBSs that offer more than 1 CD on a "turntable" system. Because of the multitasking nature of the Amiga, it is conceivable that users on different lines might be requesting files from different CDs at the same time, causing excessive wear and tear on the changer (and the sysop's nerves!) 20 F Validate Uploads This flag indicates that files uploaded to the area must be validated before they can be made available to users or for FREQing. You will be alerted to unvalidated files next time that you log on the BBS. 21 M F Message Capacity (M) Validation Area (F) Message Areas: This defines how many messages are to be kept in the message area. When more than that number of messages is added to the area (user writing message, imported message), the lowest number message will be deleted until the number of messages is equal to this number. Any number between 10 and 9000 may be entered. Defaults to 100. File Areas: If the Validate Uploads flag is set, this number will indicate a file area to copy the file to while it is awaiting validation. Not to worry, when the file is validated it will be returned to whence it came. You do not have to set an area here, as the file can be held right where it is if you wish. 22 M Renumber Trigger When the message number of the highest message in an area exceeds this number, the message area will be renumbered. To cut down on system drag, this only occurs when you, the sysop, run the Renumber utility. This number cannot be lower than the capacity of the area. Defaults to 500. Cannot be more than 9999. 23 M Character Set This defines a character set to use to translate messages to another format, such as Norwegien character sets or Macintosh 7-bit. You may only select from a list of installed character sets. Defaults to 0 (PORT DEFAULT). 12. Resource Manager Error Codes These error codes will be of most use to programmers, including those using Arexx. The DLG shell commands for resource management do not return these codes, but "filter" them for you and attempt to display meaningful error messages instead. Code Meaning Applicability Notes ==== ====================== ============= ================================ 0 No error All -1 Bad Message Type All Only send one of the supported message types listed in dlg/resman.h -2 Port already active Ports Don't activate the same port twice. -3 Port not active Ports Deactivation and locking requires an active port. -4 Resource not locked All You'll see this if you used the wrong password or if you're going for an "immediate" lock which fails. -5 ResMan not active All You'll get this if DLG's resource manager, ResMan, is not running. This probably means you don't have DLG running, either. -6 Out of Memory All -7 Area in Use Areas You'll see this if you are attempting to get an exclusive lock on a message or file area, but someone's still in it. Always count up the users in an area before locking it. -8 Bad Area Number Areas You'll see this if you are attempting to get a lock on a message or file area that does not exist. -9 Area Empty Areas This tells you that an area has no users in it. -10 Language does not exist Language The requested language does not exist for the module specified (if specified). -11 Nonexistant resource All The requested resource does not exist. -12 Resource in use All -13 Can't load menu Menu The specified menu cannot be locked. It might be in use. It might not exist.